HCL Sametime wiki: Deployment scenarios: Deploying Cisco Plug-in’s into an Integrated Lotus Notes with Embedded Sametime 8.5.1 Client

Deploying Cisco Plug-in’s into an Integrated Lotus Notes with Embedded Sametime 8.5.1 Client

Added by ~Ted Nonaplopoopsi | Edited by ~Ted Nonaplopoopsi on November 8, 2010 | Version 15

This article goes through the steps needed for deploying the Cisco Phone Control and Presence 8.0 and Cisco Unified Messaging Release 8.0 with Lotus Sametime Plug-in’s with the Integrated Lotus Notes 8.5.1 Fixpack 4 with Embedded Sametime 8.5.1 Client.

Tags: Cisco, Plugin, Widgets, extension.xml, Sametime 8.5.1

ShowTable of Contents

HideTable of Contents

0.1 Cisco Phone Control and Presence 8.0 Plug-in
0.2 Cisco Unified Messaging 8.0 Plug-In
0.3 Create an Eclipse Update Site
0.4 Create a Widget catalog database
0.5 Importing the Plug-In Update Site
0.6 Creating a widget for your plug-in
0.7 Create a Managed Setting to update the plugin_customization.ini file

As part of this article, it is assumed that the Sametime 8.5.1 Embedded Client has already been installed into your Lotus Notes 8.5.1 Client that has had Fixpack 4 applied as per the Sametime Documentation recommended system requirements. (Lotus Notes 8.5.1 & 8.5.2 do NOT ship with the Embedded Sametime 8.5.x client – they ship with the 8.0.2 Sametime embedded client)

Cisco Phone Control and Presence 8.0 Plug-in

You will need to obtain the Cisco Phone Control and Presence 8.0 with IBM Lotus Sametime Plug-In which is available from Cisco. For this article I will assume that you have access to the download.

Here is a link to the Integration Note for the Deploying of the Cisco Phone Control and Presence 8.0 with IBM Lotus Sametime:

http://www.cisco.com/en/US/docs/voice_ip_comm/cucibmlotus/cpcap/8x/english/integration/guide/cpcapig.html#wp64653

Follow the instructions in this document for the configuring of the update site.

However, when you read the section:

2. How to Set Up the Plug-in Update Site, there is a Note that states:

If Cisco Unified Messaging with IBM Lotus Sametime is also being deployed, copy all the .jar files from the UpdateSite/plugins and UpdateSite/features directories of that package to the respective directories in this package. This creates a combined update site so that the plug-ins can be configured together.

What I have learnt from previous implementations is DO NOT DO THIS as it does not work. If you have a combined Update Site, then the Unified Messaging Plug-In, will not install and constantly errors. You must create separate Update Sites.

Cisco Unified Messaging 8.0 Plug-In

You will need to obtain the Cisco Unified Messaging 8.0 with IBM Lotus Sametime Plug-In which is available from Cisco. For this article I will assume that you have access to the download.

Here is a link to the Release Notes for Cisco Unified Messaging 8.0 with IBM Lotus Sametime:

http://www.cisco.com/en/US/docs/voice_ip_comm/cucibmlotus/unifiedmsg/8x/release/notes/801cumstrn.html

Follow the instructions in this document for the configuring of the update site.

Create an Eclipse Update Site

If you already have Eclipse update site in your Domino environment, you can skip this step.

The easiest way to create an Eclipse Update Site is to use Notes 8.x Eclipse Update Site template.

Go to File ð Application ð New, enter the required data, and check the Show advanced templates check-box. Be sure you selected your server for template list. Select the Eclipse update site and click OK. When the process finishes, you will have your eclipse update site.

Create a Widget catalog database

Again, if you already have a widget catalog database in your Domino environment, you do not need to read this.

The easiest was to create a Widget Catalog is to use Notes 8.x Widget Catalog template.

Go to File ð Application ð New, enter the required data, and check the Show advanced templates check-box. Be sure you selected your server for template list. Select the Widget Catalog and click OK.

When the process finishes, you will have your widget catalog.

Importing the Plug-In Update Site

Now that you have your locally saved, configured plug-in updatesite files along with your eclipse update site and widget catalog on your Domino server, you can proceed with deployment.

What you need to do now is to import your plug-in to your eclipse update site database. This is a simple step.

Open your Eclipse Update Site database and click on the Import local update site action button. A dialog pops up. All you need to do is to point the location of the updatesite folder of the configured plug-in and select the site.xml file on your hard drive and select OK. If all goes well, you should have an update site imported in about a minute or so.

You will need to repeat this process for each update site that you want to import.

You should see something like this:

alt text

Creating a widget for your plug-in

To deploy a plug-in for the integrated Lotus Notes with embedded Sametime client, you need to create a widget from your update site.

You will have to manually create your own extension.xml file that you will attach to the Widget. It was my experience that attempting to use the “wizards” does NOT generate a correctly formed extension.xml file whereas manually created ones work.

You can name the file whatever you want, as long as it has the correct format. Below is the content of my extension file used for the Cisco Phone Control and Presence Plug-In (attributes marked bold are changeable).

<?xml version="1.0" encoding="UTF-8"?>

<palleteItem id="com.cisco.sametime.phone.featurest800" imageUrl=""

providerId="com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning"

title="Cisco Phone Control and Presence"

url="nrpc://myupdatesiteserver.com/__482577b9000551b5/site.xml">

</preferences>

<data>

<![CDATA[

<installfeature description="Cisco Phone Control and Presence"

id="com.cisco.sametime.phone.featurest800"

name="Cisco Phone Control and Presence"

required="true">

</requirements>

</installfeature>

</install>

]]>

</installManifest>

</data>

</palleteItem>

</webcontextConfiguration>

PalleteItem id, InstallFeature and Feature id must be the same as ID of the plug-in in the update site.
PalleteItem title, InstallFeature, description and name are totally up to you
Feature id version must correspond to the value of the field Version in the update site document.
URL - I have found that you must use the nrpc format (for some reason http doesn’t appear to work). The link can be obtained by going to the actions menu of your eclipse update site database and select Show URL’s

Go to your widget catalog database, click the “Create New widget” action button.

Type in the name of your widget and a description.

Make sure that you specify a category for your widget and then attach the created extension.xml file.

Save the document and you should have a widget, ready to deploy.

If you are deploying the Cisco Phone Control and Presence Plug-In, you will need to create 2 widgets (along with a separate extension.xml file for each) in order for these features to be implemented. One widget for the Cisco Phone Control and Presence with Lotus Sametime and one for the Cisco JTAPI for Phone Control and Presence with Lotus Sametime.

The other item that you will need to implement in order to have the Cisco Phone Presence status update correctly is a desktop policy setting through your Lotus Notes Administrator Client.

Create a Managed Setting to update the plugin_customization.ini file

As part of the Cisco Phone Control and Presence Plug-In configuration there is a section in the documentation that refers to Enabling Phone Status for IBM Lotus Sametime 8.5.1

In this section, there is a managed-settings.xml file created and saved into the root directory of the updatesite. What this file is supposed to do is update a setting in the user’s local C:\IBM\Lotus\Notes\framework\rcp\plugin_customization.ini file to read:

com.ibm.collaboration.realtime/enableExtendedStatus=true

In order to have this setting updated automatically rather than manually edit the file in your users Lotus Notes client when using the Integrated Lotus Notes with Embedded Sametime 8.5.1 Client, you need to create or modify a Desktop Policy setting using your Lotus Notes Administrator Client as follows:

alt text

Open your Lotus Notes Administrator Client
Select File ð Open Server ð Select your server
Click on the Person & Groups tab ð select settings

If you already have Desktop Setting document, select the one that you want to modify. If you don’t have a Desktop Policy Setting document, click on the Add Setting button and select Desktop.
With your Desktop Setting document in edit mode, use the scroll buttons at the top of the screen, until you see the Custom Settings tab

alt text

Now click on the Managed Settings tab and click Edit list
In the dialog box enter the following:

alt text

Click on the Add/Modify Value and then click OK.
You should now see this entry:

alt text

As long as this Desktop Setting is part of one of your Policies, then whoever that policy has been applied to will have this setting applied to their Lotus Notes Client, next time they authenticate with the server.

Attachments (6)

Versions (21)

Copy and paste this wiki markup to link to this article from another article in this wiki.

Link: